home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 1996 April / Software of the Month Club 1996 April.iso / pc / os2 / utlpak / calendar.txt < prev    next >
Text File  |  1996-02-21  |  6KB  |  89 lines

  1. Calendar was written by:
  2.  
  3. Leland C. Sheppard
  4. Sheppard Software Company
  5. 4621 Luneman Road
  6. Placerville, CA 95667
  7.  
  8. CIS ID: 70574,2146
  9. from the Internet: 70574.2146@Compuserve.com
  10.  
  11.   The Calendar program is shareware.  If you use the program regularly and are interested in having us continue to develop it and other such programs, you should register the program with us.  You may register Calendar for $4.00.  In order to register, fill in the Register.Txt form, make out a check payable to Leland C. Sheppard and mail both to the address shown above.
  12.  
  13.   If you are interested in the Utility Pack and you have a Compuserve ID and you prefer to register online, simply Go SWREG and register #6193 for UTLPAR.ZIP or #6194 for UTLPAK.ZIP.  Because of price constraints on SWREG, only the Utility Pack can be registered online; individual programs may be registered directly with us as described in the preceding paragraph.
  14.  
  15.   Calendar was written in VX-REXX 2.1 and requires the VX-REXX 2.1 (or higher) runtime module (VROBJ.DLL) in order to function.  Also, REXX and REXXUTIL must be installed on your system; both REXX and REXXUTIL come with OS/2.  File CALNRR.ZIP contains the VROBJ.DLL module; file CALNDR.ZIP does not.  Only one copy of VROBJ.DLL is required for all of the VX-REXX programs on your system; if you have previously downloaded a copy of it, you do NOT need to download it again.
  16.  
  17. HOW TO OPERATE CALENDAR:
  18.  
  19. The left and right arrows in the upper corners of the monthly calendar change the month being displayed.
  20.  
  21. The left and right arrows in the lower corners change the year being displayed.
  22.  
  23. Pressing the year pushbutton displays a calendar for the entire year (or 2 semiannual windows if you are running at standard VGA resolution - 640x480).  If you change the year in the monthly window, push the year button again to update the yearly calendar display.
  24.  
  25. You can specify foreground and background colors for various types of dates: holidays, birthdays, etc.  The sample ini file below shows each of the types currently supported.
  26.  
  27. You can specify dates to be highlighted as shown in the samples below for whatever purposes you choose.  If you specify a type that Calendar does not recognize, it will default to holiday.
  28.  
  29. You can update Calendar.Ini while Calendar is active.  Press the month name button and Calendar will load E.Exe (unless you have specified a different editor) and display the Calendar.Ini file for you to edit.  When you have finished editing the file, save it and exit the editor.  Calendar will immediately process the updated Ini file.  If you have the annual or semiannual calendar windows open, press the year button on the month display to update the yearly display with the new information from the updated Ini file.
  30.  
  31. NOTE: the spacing shown in the sample ini file below is required; i.e., a space before and after the equal sign is required and for the date specifications, the spaces between the pieces of information is required.  If you omit the spaces, Calendar will not understand what it is that you want to do.
  32.  
  33. Double click on the button in the upper left corner of the Calendar window or press Alt-F4 to end Calendar.
  34.  
  35. Sample Calendar.Ini contents:
  36.  
  37. HolidayFore = Black          - foreground color for holiday display
  38. HolidayBack = Red            - background color for holiday display
  39. VacationFore = Black         - etc. 
  40. VacationBack = Blue
  41. TodayFore = White
  42. TodayBack = DarkGray
  43. BirthdayFore = Black
  44. BirthdayBack = Green
  45. AnniversaryFore = Black
  46. AnniversaryBack = Cyan
  47. Editor = E.Exe               - defaults to System Editor; you can override here
  48. 01Jan H                      - specific date, every year, holiday (US: New Years Day)
  49. 17Jan H                      - same, holiday (US: Martin Luther King Day)
  50. 04Jul H                      - same, holiday (US: Independence Day)
  51. 25Dec H                      - same, holiday (US: Christmas Day)
  52. 22Jan B                      - specific date, every year, birthday
  53. 23Jun B                      - same
  54. 17Nov A                      - specific date, every year, anniversary
  55. 21May1996 4 V                - start date, this year only, number of days, vacation
  56. 19Dec 4 V                    - every year, 4 days, same dates, vacation
  57. 3 Monday Feb H               - third, day-of-week, of month, holiday (US: President's Day)
  58. last Monday May H            - last, day-of-week, of month, holiday (US: Memorial Day)
  59. 1 Monday Sep H               - first, day-of-week, of month, holiday (US: Labor Day)
  60. 4 Thursday Nov H             - fourth, day-of-week, of month, holiday (US: Thanksgiving Day)
  61.  
  62. LIMITATIONS:
  63.  
  64. Calendar will not calculate across the end of a month for the options with a duration in days.  You will need to make 2 entries to handle this situation, 1 for each month in which a portion of the designated time falls.  For example, if you wanted to highlight a 10 day period starting 27 May, you would need to code: 27May 5 V and 01Jun 5 V.
  65.  
  66. Comments you enter in the .Ini file must start with "/*"; they cannot be on the same line with holiday, editor or color data.
  67.  
  68.  
  69. Thank you for your interest in our software.
  70.   
  71. Leland C. Sheppard, 1-18-1996
  72.  
  73. Version 2.0
  74.  
  75. Changes from version 1.2 to 2.0:
  76.  
  77. Added Calendar.Ini file which contains color combinations for various types of days (holidays, birthdays, etc.)  Also added ability to specify various types and ranges of dates in the Ini file which are to be highlighted.  Added ability to split annual calendar into 2 semiannual windows for VGA resolution screens.  
  78. Changed window alignment so that both monthly and annual windows will show at the same time without you having to move either.  Added ability to update Ini file and reprocess it while Calendar is active.  Added display of holidays, etc. to annual and semiannual windows.
  79.  
  80. Changes from version 1.1 to 1.2:
  81.  
  82. Implemented internal method for determining screen resolution.  Parameter no longer needed for SVGA resolution.  Add logic to increase font size on yearly display for 1024x768 and higher SVGA screen resolutions.
  83.  
  84. Changes from version 1.0 to 1.1:
  85.  
  86. Change the annual calendar to fit VGA and SVGA screen resolutions.
  87.  
  88. (c) Copyright Leland C. Sheppard, 1994-1996.  All rights reserved.
  89.